USPS Pricing Engine Web Services 


December 18, 2018 


Summary 
This is the Domestic and International Pricing Engine Web Services (version 11.7.0.0) for the January 27, 
2019 Release. The following is a list of enhancements included in this release. 


BNS 1188 - Omnibus Price Change - Regulatory Rate Change (Competitive and 
Market Dominate) 

Actual changing of prices other than structural (i.e. a price cell change). In addition to mail/extra service 
price changes, prices for surcharges, discounts, and mailing fees have been changed as well. 


Changes to the Database Structure 
New databases are created to support domestic and international logic and prices. These databases are 
named USPS_DOM_2019_01 and USPS_INTL_2019_01 respectively. 


BNS 1177 - FCPS Implementation of Zone Based Pricing 
Add zone based pricing structure to our existing ounce based pricing structure for all FCPS customers. 


This only affects Priority Mail. Operations have found it is more feasible to process the APO/FPO/DPO 
Priority Mail (only) in Chicago, for all theaters, then transport to the outgoing facilities. 


Customer Maps impacted by this change 

CNSB_eVS_009B6 eVS_025P6 
CNSB_eVS_009B8 MRS_017B4 
CNSB_Meter_O09B5 PC_ Postage _007B7 
EASRv2_015B4 PriceCalc_014X0 
eVS_011B6 SBP_022B6 
eVS_025B6 WebTools 004B4 
eVS_025P6 


Changes to the Database Structure 
A new table, dm_first_class_package_service, has been created to support zone based pricing. 


BNS 1217 - Elimination of FCMI Flats Weight Steps over 15.994 ounces 
Eliminate the FCMI Flats/Large Envelopes weight steps over 15.994 ounces. 


NOTE: If a customer requests a flat over 15.994 ounces, the FCPIS mail service will be returned 
(depending on country limits). 


BNS 1169, 1192, 1193 - Dim Weight BNSs - Domestic Business Calculator 
Apply dimensional weight pricing calculation to Priority Mail, Priority Mail Express, and Parcel Select. 
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For Priority Mail, dimensional weight will be applied to all zones. The dimensional weight divisor will 
vary by zone. Balloon pricing is no longer applicable. 


For Priority Mail Express, dimensional weight will be applied to all zones. The dimensional weight 
divisor will vary by zone. 


For Parcel Select Destination Entry Machinable and Non-machinable, dimensional weight will be applied 
to DNDC Entry Zones 1-5, DSCF Entry 5-Digit and 3-Digit, and DDU. The dimensional weight divisor will 
vary by zone. 


Changes to the Database Structure 
A new table, named the DimensionalWeightDivisor, has been added to maintain the divisor assigned to 
each zone and mail class. 


BNS 1216 Premium Forwarding Service 

Allow PO Box holders (excluding Group E box customers) to pay an additional fee to have their PO Box 
mail delivered to their street delivery address in lieu of having to travel to the Post Office to pick up their 
PO Box mail. 


These fees are accessible through the MailingFees API, Key name PremiumForwardingService, sub-keys 
Local\EnrollmentFee\Online and Local\ReshipmentFee. 


BNS 1216 Update SKU Definition in Mailing Fees 


Support additional fees for Premium Forwarding Service: 
e Commercial - Priority Mail 
o Enrollment Fee - Online 19.35 
o Shipment Charge 21.10 
e Residential - Priority Mail 
o Enrollment Fee - Online 19.35 
o Shipment Charge 21.10 


BNS 1225 Small Parcel Forwarding Fee 

This fee is added so that the customer could designate that they want the piece forwarded at the time 
of mailing if the address in no longer valid and there is a COA on file. They would be charged a flat fee 
for that forwarding. 


These fees are available through the MailingFees API, Key name AddressCorrection, sub-key 
PerPieceForwardingFee\USPSMarketingMail\Parcel and 
PerPieceForwardingFee\ParcelSelectLightweight\Parcel. 


BNS 1169, 1192, 1193 - PM Balloon Rate is being used for all zones 


The Priority Mail balloon rate is being applied all zones when calculating the price using the 2018 Price 
Change data. Updated code to correctly apply the balloon rates based on the dim wt. table. 
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BNS 1169, 1192, 1193 - Return Dimensional Weight to WebTools 


When dimensional weight is used to calculate the postage, return the dimensional weight in the Postage 
Services - DimensionalWeight attribute for the CalculateSevicePrice and GetServicesWithPricing 
Methods. 


Otherwise, do not return the Postage Services- DimensionalWeight attribute. 


BNS 1188 - CR 1188.4 - Country Name Changes - Implementation 
There are a number of country name changes. 
e Swaziland (Country ID 10410) will be updated to Eswatini 
e Country IDs to have the Country Code updated to UK and the description updated with United 
Kingdom of Great Britain and Northern Ireland 
o 10140 - Alderney (Channel Islands) (Great Britain and Northern Ireland) updated 

to Alderney (Channel Islands) (United Kingdom of Great Britain and Northern Ireland) 
10141 - Channel Islands (Jersey, Guernsey, Alderney and Sark) (Great Britain and 
Northern Ireland) updated to Channel Islands (United Kingdom of Great Britain and 
Northern Ireland) 
10142 - England (Great Britain and Northern Ireland) updated to England (United 
Kingdom of Great Britain and Northern Ireland) 
10143 - Great Britain and Northern Ireland updated to United Kingdom of Great Britain 
and Northern Ireland 
10144 - Guernsey (Channel Islands) (Great Britain and Northern Ireland) updated to 
Guernsey (Channel Islands) (United Kingdom of Great Britain and Northern Ireland) 
10145 - Isle of Man (Great Britain and Northern Ireland) updated to Isle of Man (United 
Kingdom of Great Britain and Northern Ireland) 
10146 - Jersey (Channel Islands) (Great Britain and Northern Ireland) updated to Jersey 
(Channel Islands) (United Kingdom of Great Britain and Northern Ireland) 
10147 - Northern Ireland (Great Britain and Northern Ireland) updated to Northern 
Ireland (United Kingdom of Great Britain and Northern Ireland) 
10148 - Sark (Channel Islands) (Great Britain and Northern Ireland) updated to Sark 
(Channel Islands) (United Kingdom of Great Britain and Northern Ireland) 
10149 - Scotland (Great Britain and Northern Ireland) updated to Scotland (United 
Kingdom of Great Britain and Northern Ireland) 
10150 - United Kingdom (Great Britain and Northern Ireland) updated to United 
Kingdom (United Kingdom of Great Britain and Northern Ireland) 
10151 - Wales (Great Britain and Northern Ireland) updated to Wales (United Kingdom 
of Great Britain and Northern Ireland) 


BNS 1169, 1192, 1193 - Implement Solutions to Accommodate Split Retail - 


Commercial Price Change 

The proposed changes to Jan 2019 Price Change would mean that the Dim Wt changes will only be 
applied to Retail and not to Commercial. In that case, prices returned from Price Engine would have 
Dim Wt applied to “R” rates but not to “CB” and “CP” rates on the “B” and “P” maps. 
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BNS 1169.5, 1192.5, 1193.5 - Disable Dim Weight 


Much of the planned dimensional weighting is being deferred until June 23, 2019. The list below details 
the plan forward. 


Priority Mail Commercial DIM weight provisions apply to Zones 5 through 9 with a divisor of 194 
will remain. Priority Mail Commercial DIM weight provisions apply to Zones 1 through 9 with a 
divisor of 166 effective June 23, 2019. 

Priority Mail Retail DIM weight provisions apply to Zones 5 through 9 with a divisor of 194 will 
remain. Priority Mail Retail DIM weight provisions apply to Zones 1 through 9 with a divisor of 
166 effective June 23, 2019. 

Priority Mail Retail and Commercial Balloon is eliminated effective Jan, 27, 2019 

Express Mail Commercial DIM weight apply through Zones 1 through 9 with a divisor of 166 
effective June 23 

Express Mail Retail DIM weight apply through Zones 1 through 9 with a divisor of 166 effective 
June 23. 

Parcel Select Ground and Destination Entry DIM weight provisions apply to all zones and all 
entries with a divisor of 166 effective June 23, 2019 

Parcel Select Ground and Destination Entry Balloon is eliminated effective Jan, 27, 2019 

USPS Retail Ground formerly known as Parcel Post will continue to have Balloon and No Dim 
provisions. 


BNS 1228 Priority Mail Sunday/ 7 Day Delivery Expansion - Price Engine 


Analysis & Implementation 
Return delivery commitments for Priority Mail Sunday/7 Day Delivery. 


BNS 1217 - Modifications and Promote new price files for the FCMI change 

This modification backs out the changes made by the initial release “BNS 1217Eliminate the FCMI 
Flats/Large Envelopes weight steps over 15.994 ounces”. First-Class Mail International Flats/Large 
Envelope returns the updated prices for up to 64 ounces (4 lbs) for Jan 2019 Price Change, matching the 
current 2018 functionality. 


BNS 1188 - Update SDR Value 
This update includes a script to update the Special Drawing Rights. 


BNS 1177 - Zone Chart - First-Class Package Services / 2019 Update 
Support zone exceptions for First-Class Package Service to some APO/FPO/DPO ZIP Codes. 


Impact on Existing Applications 
WSDLs have not been update; you should not have to rebuild your applications. 


Reported Defects and Change Request 





BNS 1169, 1192, 1193 - PM Balloon Rate is being used for all zones Corrected 











BNS 1188 - Incorrect Mailing Fee DML/DAL for Targeted Samples Corrected 
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BNS 1188 - FCM Letters - Nonmachinable Surcharge Incorrect Corrected 





BNS 1188 - CR 1188.4 - Update ICLs (GetCountryRegulations). Corrected 





BNS 1188 - Update SDR Value with Info from Global group Corrected 








BNS 1217 - Restore change to remove BNS 1217 from January 2019 Price Change and Corrected 
revert back to 64 ounces on FCMI 








BNS 1169, 1192, 1193 - PM Balloon Rate is being used for all zones 
Updated code to correctly apply the balloon rates based on the dim wt. table. 


BNS 1188 - Incorrect Mailing Fee DML/DAL for Targeted Samples 

Updated database values for DomesticBusinessMailing. DetachedAddressLabels.TargetedSamples and 
DomesticBusinessMailing.DetachedMarketingLabels.TargetedSamples. The cost was corrected to equal 
0.00. 


BNS 1188 - FCM Letters - Nonmachinable Surcharge Incorrect 
Update database footnotes to correct the value of the nonmachinable surcharge to read 0.150. 


BNS 1188 - CR 1188.4 - Update ICLs (GetCountryRegulations). 
A name change for Swaziland to Eswatini. 


BNS 1188 - Update SDR Value 
The Global group provided new information pertaining to what this value should be. 


BNS 1217 - Restore change to remove BNS 1217 from January 2019 Price Change and revert 


back to 64 ounces on FCMI 
This script was dropped from the sql_update.bat file by mistake. 
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